home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / tcl / Tcl_SetVar.man < prev    next >
Encoding:
Text File  |  1989-11-27  |  2.1 KB  |  69 lines
  1.  
  2.  
  3.  
  4. Tcl_SetVar        Tcl Command Language Library         Tcl_SetVar
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      Tcl_SetVar - change the value of a Tcl variable
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ##iinncclluuddee <<ttccll..hh>>
  15.  
  16.      TTccll__SSeettVVaarr(_i_n_t_e_r_p, _v_a_r_N_a_m_e, _n_e_w_V_a_l_u_e, _g_l_o_b_a_l)
  17.  
  18. AARRGGUUMMEENNTTSS
  19.      Tcl_Interp   *_i_n_t_e_r_p   (in)      Interpreter  in  which   to
  20.                                       change variable.
  21.  
  22.      char         *_v_a_r_N_a_m_e  (in)      Name of variable.
  23.  
  24.      char         *_n_e_w_V_a_l_u_e (in)      New value for _v_a_r_N_a_m_e
  25.  
  26.      int          _g_l_o_b_a_l    (in)      If non-zero, then insist on
  27.                                       interpreting  _v_a_r_N_a_m_e  as a
  28.                                       global variable, regardless
  29.                                       of   whether   a  procedure
  30.                                       invocation is in progress.
  31.  
  32. _________________________________________________________________
  33.  
  34.  
  35. DDEESSCCRRIIPPTTIIOONN
  36.      This is a utility procedure used by many  of  the  Tcl  com-
  37.      mands.   It  changes the value of variable _v_a_r_N_a_m_e in inter-
  38.      preter _i_n_t_e_r_p, such that future  calls  to  TTccll__GGeettVVaarr  will
  39.      return  _n_e_w_V_a_l_u_e  as  the value of _v_a_r_N_a_m_e.  TTccll__SSeettVVaarr uses
  40.      the same rules for selecting a global or local  variable  as
  41.      TTccll__GGeettVVaarr.   If  _v_a_r_N_a_m_e  doesn't already exist, then a new
  42.      variable is created.  TTccll__SSeettVVaarr  copies  both  _v_a_r_N_a_m_e  and
  43.      _n_e_w_V_a_l_u_e  into  its  own  private storage, so the caller may
  44.      change  the  contents  of  these  strings  after  TTccll__SSeettVVaarr
  45.      returns without affecting the variable's value.
  46.  
  47.  
  48. KKEEYYWWOORRDDSS
  49.      interpreter, variable
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  November 26, 1989                  1
  66.  
  67.  
  68.  
  69.